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1 Understanding users II: A qualitative assessnnent of the efficacy of UML diagrams as a 
fornn of graphical documentation in aiding program understanding 
Scott Tilley, Shihong Huang 

October 2003 Proceedings of the 21st annual international conference on 
Documentation 

Full text available: ^ pdf(274.99 KB) Additional Information: full citation , abstract , references , index terms 

Graphical documentation is often characterized as an effective aid in progrann 
understanding. However, it is an open question exactly which types of graphical 
documentation are most suitable for which types of program understanding tasks (and in 
which specific usage contexts). The Unified Modeling Language (UML) is the de facto 
standard for modeling modern software applications. This paper describes an experiment to 
assess the qualitative efficacy of UML diagrams in aiding program understanding. ... 

Keywords: Unified Modeling Language (UML), assessment, graphical documentation, 
program understanding 



Differences between versions of UML diagrams 
Dirk Ohst, Michael Welle, Udo Kelter 

September 2003 ACM SIGSOFT Software Engineering Notes , Proceedings of the 9th 

European software engineering conference held jointly with 10th ACM 
SIGSOFT international symposium on Foundations of software 
engineering, Volume 28 issue 5 

Full text available: g pdf(202.32 KB) Additional Information: full citation , abstract , references , index terms 

This paper addresses the problem of how to detect and visualise differences between 
versions of UML documents such as class or object diagrams. Our basic approach for 
showing the differences between two documents is to use a unified document which 
contains the common and specific parts of both base documents; the specific parts are 
highlighted. The main problems are (a) how to abstract from modifications done to the 
layout and other (document type-specific) details which are considered irrelevan ... 

Keywords: UML diagrams, configuration, design transaction, differences, fine-grained data 
model, software engineering environments, versions 



3 Transformations and Experiences: VXT: a visual approach to XML transformations 
Emmanuel Pietriga, Jean-Yves Vion-Dury, Vincent Quint 

November 2001 Proceedings of the 2001 ACM Symposium on Document engineering 

Full text available: ■ p i pdfd 65.99 KB) Additional Information: full citation , abstract , references , citings, index 
^ terms 
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The domain of XML transformations is becoming more and more important as a result of the 
increasing number of applications adopting XML as their format for data exchange or 
representation. Most of the existing solutions for expressing XML transformations are 
textual languages, such as XSLTor DOM combined with a general-purpose programming 
language. Several tools build on top of these languages, providing a graphical environment. 
Transformations are however still specified in a textual way using ... 

Keywords: XML transformations, XSLT, circus, visual programming languages, zoomabie 
user interfaces 



Software engineering: Elucidative Programming in open integrated developnnent 
environments for Java 
Thomas Vestdam 

June 2003 Proceedings of the 2nd international conference on Principles and practice 
of programming in Java 

Full text available: ^ pdf(45Q.76 KB) Additional Information: full citation , abstract , references , index terms 

In this paper we present an integration of tool support for internal documentation in the 
modern IDE Together J. The specific kind of internal documentation stems from the 
Elucidative Programming tradition where documentation and source code are separate 
entities tied together using hyperlinks. The tool supports the programmer in creating and 
managing internal documentation of Java source code. The hypertext-based documentation 
is presented in the IDE where a range of navigational features helps ... 

Keywords: Java, documentation, elucidative programming, literate programming 



^ The Pan language-based editing system 

Robert A. Ballance, Susan L. Graham, Michael L. Van De Vanter 

January 1992 ACM Transactions on Software Engineering and l^ethodology (TOSEI^), 

Volume 1 Issue 1 

Full text available: ffi pdf(2.43 IVIB) Additional Information: full citation , abstract , references , citings , index 
^ terms , review 

Powerful editing systems for developing complex software documents are difficult to 
engineer. Besides requiring efficient Incremental algorithms and complex data structures, 
such editors must accommodate flexible editing styles, provide a consistent, coherent, and 
powerful user interface, support individual variations and projectwide configurations, 
maintain a sharable database of information concerning the documents being edited, and 
Integrate smoothly with the other tools in the environme ... 

Keywords: Ladle, Pan, coherent user interfaces, colander, contextual constraint, extension 
facilities, grammatical abstraction, interactive programming environment, logic 
programming, logical constraint grammar, reason maintenance, syntax-recognizing editor, 
tolerance for errors and anomalies 



Extended programming in the large in a software development environment 
Claus Lewerentz 

January 1989 Proceedings of the third ACM SIGSOFT/SIGPLAN software engineering 

symposium on Practical software development environments, Volume 24 , i3 

Issue 2 , 5 

Full text available: 1 ^3 pdf(3.54 MB) Additional Information: full citation , abstract , references , citings , index 
^ terms , review 

This paper deals with the programming in the large part and the integration with related 
activities (programming in the small, variant control, support of technical documentation, 
responsibility and access control) of the software development and maintenance process. It 
is pointed out how these tasks are supported with an integrated and incremental software 
project support environment (IPSEN). Snapshots of a working session are used to 
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Customizing lotus notes to build software engineering tools 
Jun Ma, Holger M. Kienle, Piotr Kaminski, Anke Weber, Marin Litoiu 

October 2003 Proceedings of the 2003 conference of the Centre for Advanced Studies 
conference on Collaborative research 

Full text available: ^ pdf(337.86 KB) Additional Information: full citation , abstract , references , index terms 

Many software engineering research tools are stand-alone applications that have trouble 
interoperating with other development tools and do not fit well into the software 
developers' established work processes. Our main hypothesis is that in order for new tools 
to be adopted effectively, they must be compatible with both existing users and existing 
tools.Typically, software engineering teams in an organization share a set of common 
applications for their development activities that are a permanen ... 

Keywords: Lotus notes, Rigi, collaboration, customization, end-user programmable 
systems, tool adoption 



PICS: Internet access controls without censorship 
Paul Resnick, James Miller 

October 1996 Communications of the ACM, Volume 39 issue lo 

Full text available: pd f(2 91 .57 KB) Additional Information: full citation , references , citings , index terms 



Book Review SGML CD: A Complete SGML Toolkit 

Terry Dawson 

March 1998 Linux Journal 

Full text available: [g| htmi(5.14 KB) Additional Information: full citation , index terms 



^0 Playing detective with full text searching software 
Darrell R, Raymond, Heather J. Fawcett 

September 1990 ACM SIGDOC Asterisk Journal of Computer Documentation , 

Proceedings of the 8th annual international conference on Systems 
documentation, volume 14 issue 4 

Full text available: ^ pdfd.OI MB) Additional Information: full citation , abstract , index terms 

Searching large text databases often resembles detective work. We explored this notion 
with an experiment in which subjects used powerful full text searching software to solve 
problems about the Arthur Conan Doyle story The Hound of the Baskervilles. The 
experiment was conducted in two parts: in the first part subjects attempted to teach 
themselves about the software using only the documentation; in the second part, subjects 
used the software to answer questions such as 

Documentation production from a formal database 
Christopher Hartsough, Yuzo Yamamoto, E. David Callender 

January 1982 Proceedings of the 1st annual international conference on Systems 
documentation 

Full text available: fi!|pdf(899 18 KB) Additional Information: full citation , abstract , references , citings , index 
^ terms 

This paper reports on an existing, operational prototype system, TG/TF2, for the generation 
of typeset quality documentation from a formal database. TG/TF2 directly supports the 
conceptual separation of system design, document content design, and document format 
design. Specifically, support for system design is supplied by Problem Statement 
Language/Problem Statement Analyzer (PSL/PSA), a development of the ISDOS Project at 
the University of Michigan. Document content design support is pro ... 
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code 

Michael L. Collard, Jonathan I. Maletic, Andrian Marcus 

November 2002 Proceedings of the 2002 ACM symposium on Document engineering 

Full text available: ^ pdf(162.30 KB) Additional Information: full citation , abstract , references , index terms 

The paper describes the use of an XML format to store and represent program source code. 
A new XML application, srcML (SouRCe Markup Language), is presented. srcML presumes a 
document view of source code where information about the syntactic structure is layered 
over the original source code document. The resultant multi-layered document has a base 
layer of all the original text (and formatting). The second layer is the syntactic information, 
derived from the grammar of the programming language, ... 

Keywords: XML, abstract syntax tree, markup language, program analysis, source code 



13 Navigating online information: a characterization of extralinquistic factors that influence 
user behavior 
Brad Mehlenbacher 

November 1992 Proceedings of the 10th annual international conference on Systems 
documentation 

Full text available: ' glpdf(l14 MB) Additional Information: full citation , abstract , references , citings , index 

terms 

The paper examines the extrallnguistic factors that influence user behavior with online 
information systems. Extralinguistic factors include any interface features which are 
"outside" how users understand and comprehend written texts online. Extralinguistic 
features, therefore, are interface features that support (1) how users formulate their 
information goals or represent their tasks, (2) how users navigate to new or related topics 
of interest to them, and (3) how users quickly ... 

1^ indexing and retrieval of scientific literature 
Steve Lawrence, Kurt Bollacker, C. Lee Giles 

November 1999 Proceedings of the eighth international conference on Information and 
knowledge management 

Full text available* fgl pdf(985 22 KB) Additional Information: full citation , abstract , references , citings , index 
^ ' terms 

The web has greatly improved access to scientific literature. However, scientific articles on 
the web are largely disorganized, with research articles being spread across archive sites, 
institution sites, journal sites, and researcher homepages. No Index covers all of the 
available literature, and the major web search engines typically do not Index the content of 
Postscript/PDF documents at all. This paper discusses the creation of digital libraries of 
scientific literature on the web, inci ... 

UNIX Emacs: a retrospective (lessons for flexible system design) 
Nathaniel S. Borenstein, James Gosling 

January 1988 Proceedings of the 1st annual ACM SIGGRAPH symposium on User 
Interface Software 

Full text available* ^ pdf(842.24 KB) Additional Information: full citation , abstract , references , citings , index 

terms 

UNIX Emacs is well-known and widely used as a text editor that has been extended in a 
remarkable number of directions, not always wisely. Because it is programmable in a 
powerful yet simple programming language, Emacs has been used as a development tool 
for the construction of some remarkably complex user-oriented programs. Indeed, it has 
served as both a user interface management system and a user interface toolkit, though it 
was designed as neither. In this paper, we discuss the features ... 
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Wendy Chishoinn, Gregg VanTIerheiden, Ian Jacobs 
July 2001 interactions, volume 8 issue 4 

Full text available: ■ g pdf(471.98 Additional Information: full citation , references , citings, index terms 
KB) 



^'^ How practical is practical SGML? 
Robert J. Glushko 

May 1996 ACM SIGDOC Asterisk Journal of Computer Documentation, Volume 20 issue 2 
Full text available: ^ pdf(460.54 KB) Additional Information: full citation , index terms 



New products 

CORPORATE Linux Journal Staff 

October 2001 Linux Journal, Volume 2001 issue 90 

Full text available: [g| html(6.93 KB) Additional Information: full citation 



Syntax-directed editing of general data structures 
Christopher W. Fraser 

June 1981 ACM SIGPLAN Notices , Proceedings of the ACM SIGPLAN SIGOA 
symposium on Text manipulation, volume 16 issue 6 

Full text available: 1ilM{393J6KB) Additional Information: full citation , abstract, references , dtings, index 
im-^ " terms 

Program editors help users create syntactically correct progranns. Though such editors 
nornnally edit parse trees, applying similar techniques to other tree structures that need 
editing helps both users and implementors. This paper describes an editor that accepts a 
grammar describing a hierarchical data structure and allows the user to enter and edit 
arbitrary trees having this structure. It displays the pros and cons of this approach using 
instances of this editor that edit formatted docume ... 

Specification of an object to object protocol in Abstract Syntax Notation One (ASN.1) 
Jozsef A. Toth 

June 1990 Proceedings of the third international conference on Industrial and 

engineering applications of artificial intelligence and expert systems - 
Volume 2 

Full text available: ^ pdf(566.39 KB) Additional Information: full citation , abstract , references , index terms 

Object-oriented languages and environments have opened up a new way to develop 
software. Unfortunately, object-to-object transmittal of control and data has been highly 
indigenous to its particular domain; whether it be a compiler, interpreter or database. The 
DARPA Initiative for Concurrent Engineering (DICE) has specified a DICE Communications 
Channel (DCC) in which a heterogeneous environment, including object-oriented databases 
and subsystems, has driven the requirement for an integrati ... 
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